Aviation API
28 Wind Temperature Charts
Wind and temperature forecasts are issued in chart form for specific times and levels. Wind direction and speed are indicated at selected points by wind arrows with feathers and shaded pennants, and spot temperatures are enclosed in circles. Charts are issued 4 times a day (valid at 00, 06, 12, and 18 UTC).
28.1 By Chart, Flight Level and Validity
28.1.1 Description:
Request the latest prognosis chart for the specified chart identifier, flight level, validity.
28.1.2 API Call:
GET /aviation/v2/chart/windtemp/{chart}/fl/{level}/{validity}
28.1.3 Path Parameters:
Parameter | Example | Description |
---|---|---|
chart | 108 | A supported chart identifier value as in the table below. This path parameter is Mandatory. |
level | 050 | A supported flight level. This path parameter is Mandatory. |
validity | 18 | A supported valid at time: 00,06,12,18. This path parameter is Mandatory. |
28.1.4 Example:
This example would return a link to the Wind Temperature chart for identifier 108 and flight level 050 with a valid at time of 1800 hours UTC.
All Wind Temperature charts are forecasts and as such have a prognosis period of 18 hours from the issue time.
GET /aviation/v2/chart/windtemp/108/fl/050/18
28.1.5 API Response:
{
"version": "1.0",
"issue-time": "2025-08-28T00:25:39Z",
"path": "/aviation/v2/chart/windtemp/108/fl/050/18",
"response": [
{
"met:index-time": "2025-08-27T22:20:53Z",
"met:locator": "https://test-api.metservice.com/aviation/assets/chart/windtemp/108/850/2025/08/27/18/202508271800_202508281800_202508272219.gif",
"met:analysis-time": "2025-08-27T18:00:00Z",
"met:product-name": "chart",
"av:chart-level": "850",
"met:domain": "aviation",
"met:issue-time": "2025-08-27T22:19:00Z",
"av:chart-type": "windtemp",
"met:prognosis-period": "024",
"met:valid-at": "2025-08-28T18:00:00Z",
"av:chart-id": "108",
"met:validity": "18"
}
]
}
28.2 By Chart and Flight Level for the next n hours
28.2.1 Description:
Request the prognosis charts for the specified chart identifier and flight level that have a valid at time which is within the next n hours specified.
28.2.2 API Call:
GET /aviation/v2/chart/windtemp/{chart}/fl/{level}/next/{n}/hours
28.2.3 Path Parameters:
Parameter | Example | Description |
---|---|---|
chart | 920 | A supported chart identifier value as in the table below. This path parameter is Mandatory. |
level | 185 | A supported flight level. This path parameter is Mandatory. |
n | 24 | The number of hours into the future that the validity start time of the prognosis chart should fall within. This can be up to 30 hours. This parameter is Mandatory. |
28.2.4 Example:
This example would return a set of links to charts for identifier 920 and flight level 185 with a valid at time that is within the next 24 hours from ‘now’.
GET /aviation/v2/chart/windtemp/920/fl/185/next/24/hours
28.2.5 API Response:
{
"version": "1.0",
"issue-time": "2021-10-04T23:05:34Z",
"path": "/aviation/v2/chart/windtemp/920/fl/185/next/24/hours",
"response": [
]
}
28.3 By Chart, Pressure Level and Validity
28.3.1 Description:
Request the latest prognosis chart for the specified chart identifier, pressure level, validity.
28.3.2 API Call:
GET /aviation/v2/chart/windtemp/{chart}/hpa/{level}/{validity}
28.3.3 Path Parameters:
Parameter | Example | Description |
---|---|---|
chart | 795 | A supported chart identifier value as in the table below. This path parameter is Mandatory. |
level | 850 | A supported pressure level. This path parameter is Mandatory. |
validity | 18 | A supported valid at time: 00, 06, 12, 18 This path parameter is Mandatory. |
28.3.4 Example:
This example would return a link to the Wind Temperature chart for identifier 795 and pressure level 850 with a valid at time of 1800 hours UTC.
All Wind Temperature charts are forecasts and as such have a prognosis period of 18 hours from the issue time.
GET /aviation/v2/chart/windtemp/hpa/850/18
28.3.5 API Response:
{
"version": "1.0",
"issue-time": "2021-10-04T23:09:12Z",
"path": "/aviation/v2/chart/windtemp/hpa/850/18",
"response": [
]
}
28.4 By Chart and Pressure Level for the next n hours
28.4.1 Description:
Request the prognosis charts for the specified chart identifier and pressure level that have a valid at time which is within the next n hours specified.
28.4.2 API Call:
GET /aviation/v2/chart/windtemp/{chart}/hpa/{level}/next/{n}/hours
28.4.3 Path Parameters:
Parameter | Example | Description |
---|---|---|
chart | 920 | A supported chart identifier value as in the table below. This path parameter is Mandatory. |
level | 500 | A supported pressure level. This path parameter is Mandatory. |
n | 24 | The number of hours into the future that the validity start time of the prognosis chart should fall within. This can be between 1 to 30 hours. This parameter is Mandatory. |
28.4.4 Example:
This example would return a set of links to charts for identifier 108 and pressure level 500 with a valid at time that is within the next 24 hours from ‘now’.
GET /aviation/v2/chart/windtemp/108/hpa/500/next/24/hours
28.4.5 API Response:
{
"version": "1.0",
"issue-time": "2021-10-04T23:05:34Z",
"path": "/aviation/v2/chart/windtemp/108/hpa/500/next/24/hours",
"response": [
]
}
28.5 Supported Chart Identifier and Level values
FL/hPa | FL/hPa | FL/hPa | FL/hPa | FL/hPa | FL/hPa | FL/hPa | FL/hPa | FL/hPa | ||
---|---|---|---|---|---|---|---|---|---|---|
Chart Id | Description | 530/100 | 445/150 | 385/200 | 340/250 | 300/300 | 240/400 | 185/500 | 100/700 | 050/850 |
108 | ICAO Area F - Pacific | N | Y | Y | Y | Y | Y | Y | Y | Y |
117 | ICAO Area J – South Pacific (Polar) | N | Y | Y | Y | Y | Y | Y | Y | Y |
763 | Australia East/French Polynesia | N | N | Y | Y | Y | Y | Y | Y | Y |
764 | New Zealand | N | N | Y | Y | Y | N | Y | Y | N |
783 | Asia/Australia | N | N | Y | Y | Y | N | Y | Y | N |
786 | Asia/New Zealand | N | N | Y | Y | Y | Y | Y | Y | N |
793 | Australia/New Zealand | N | N | Y | Y | Y | Y | Y | Y | Y |
802 | New Zealand/Antarctica (Polar) | N | N | Y | Y | Y | Y | Y | Y | Y |
950 | Antarctica (Polar) | N | N | N | Y | N | N | N | N | N |
979 | Pacific | N | N | Y | Y | Y | N | Y | Y | N |